Cream of the Crop 20

home *** CD-ROM | disk | FTP | other *** search

/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / bbs / high200.zip / HIGHLAND.DOC < prev next >

Wrap

Text File | 1996-05-17 | 65KB | 1,922 lines

─────────────────────────────────────────────────────────────────────────── ▓▒░ ▓▒░ ▓▒░ ▒░▓▓▒ ▓▓▒ ▓▒░ ▓▒░ ▒░▓▓▒ ▒░▓▓▒ ▓▒░▓▓▒ ░░▓▓▒ ▒░▓▓▒ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▓▒░ ▒░░▒▒░░ ▒░░ ▒░░ ▒░░▒▒░░ ▒░░ ▒░░▒▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ▒░░▒▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ▒░░ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░▒ ░░▒ ░░▒ ░░▒ ░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░░▒ ░▒ ░░▒ ░▒▓ ░▒▓ ░▒▓ ▒▓▓░▒ ░▒▓ ░▒▓ ░▒▓▓▓▒░ ░▒▓ ░▒▓ ░▒▓ ░▒▓ ░▒▓▓░▒ ▒▓▓░▒ ░▒▓ ─────────────────────────────────────────────────────────────────────────── T h e o n l y O N E l i n e r ────────────────────────────────────────────────── Written By: Steven Holme Copyright (c) 1995, 96 Fonty Technologies (UK) Inc All Rights Reserved ────────────────────────────────────────────────── Version 2.00 Released: 17 May 1996 ─────────────────────────────────────────────────────────────────────────── HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── Table of Contents 1 Introduction......................................................03 1.1 What is HiGHLANDER?...........................................03 1.2 Features......................................................03 1.3 Requirements..................................................04 1.4 Testing.......................................................04 1.5 License Agreement.............................................05 1.6 Disclaimer....................................................06 1.7 Guarentee.....................................................06 1.8 Trademarks....................................................06 2 Registering.......................................................07 3 Distribution Archive..............................................08 4 Additional Files..................................................09 5 Installation......................................................09 5.1 Quick Installation............................................09 5.2 Command Line Parameters.......................................10 5.2.1 BBS Parameters..........................................10 5.2.2 Communications Parameters...............................10 5.2.3 HiGHLANDER Parameters...................................11 5.2.3.1 Standard Parameters.............................11 5.2.3.2 Bulletin Parameters.............................11 5.3 The Configuration File........................................12 5.3.1 BBS Commands............................................12 5.3.2 Communications Commands.................................12 5.3.3 HiGHLANDER Commands.....................................13 5.3.3.1 Standard Commands...............................13 5.3.3.2 Security Commands...............................19 5.3.3.3 Menu Commands...................................20 5.3.3.4 Bulletin Commands...............................22 5.3.3.5 Protocol Commands...............................25 5.3.4 A Note On The Colour Parameters.........................25 5.5 InterBBS Configuration Files..................................26 5.4 Maintanence...................................................27 6 Future Versions...................................................28 7 Credits...........................................................28 7.1 Thanks........................................................29 7.2 Contributions.................................................29 7.3 The Beta Testers..............................................30 7.4 InterBBS Leagues..............................................30 8 Support...........................................................31 8.1 By Post.......................................................31 8.2 By BBS........................................................31 8.3 By E-Mail.....................................................31 9 Contributions.....................................................32 10 And On A Last Note...............................................32 ────────────────────────────────────────────────────────────────────── Page 2 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── 1 Introduction 1.1 What is HiGHLANDER? HiGHLANDER is a 'oneliner' door program which should work with most BBS systems. For those of you that don't know what a 'oneliner' is: it is simply a message, comment or quote which is oneline in size. Unlike most other 'oneliner' type programs HiGHLANDER is extremely easy to install and configurable to your personnal needs. HiGHLANDER was written to provide a decent oneliner door for The Fonty Towers BBS. Various BBSes were scanned for such a door and there was no success in finding a really good oneliner. Most oneliner doors where just not configurable enough. 1.2 Features In the following list of features, the {+} symbol indicates a registered only feature. HiGHLANDER includes the following list of features: ■ Displays the oneliners. ■ Displays the writers of the oneliners. ■ Displays the BBS origin of the oneliners. ■ Displays the date and time of the oneliners. ■ Displays top writers chart. ■ Top writer and non-writer statistics. ■ User downloadable statistics files. ■ Easy to use configuration files. ■ Sysop configurable main screen for personnal look and feel. ■ Sysop configurable prompts, so any language isn't a problem. ■ Sysop replacable help screen for personnal look and feel {+} ■ Sysop replacable enter screen for personnal look and feel {+} ■ External Chat Utility support. ■ External Protocol support. ■ Log file support. ■ Multi-node support. ■ InterBBS support. ■ Unique Key System {+} ────────────────────────────────────────────────────────────────────── Page 3 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── 1.3 Requirements The following requirements are necessary to run HiGHLANDER: ■ An IBM PC, XT, AT or 100% compatible PC with a hard disk. ■ Microsoft MS-DOS, IBM PC-DOS or DR-DOS version 3.30 or later. ■ A BBS system, though strictly speaking this is not a necessity. ■ At least 200KB of RAM available. 1.4 Testing HiGHLANDER has been successfully tested with the following configurations: ■ Systems equiped with Intel/AMD 80286, 80386, 80486 processors. ■ MS-DOS v5.0, v6.0, v6.2, and v6.22. ■ Microsoft Windows'95. ■ 4DOS v5.5. ■ Norton DOS. ■ Novell Netware Lite v1.1. ■ LANtastic v6.0 ■ QuarterDeck DESQview v2.60, v2.61, v2.62, and v2.70 ■ X00 v1.53a ■ BNU v1.70 HiGHLANDER has been successfully tested with the following external chat utilities: ■ IceChat v3.80, v4.10, and v4.30 ■ LightChat v1.10 HiGHLANDER has been successfully tested with the following external protocol programs: ■ DSZ and GSZ ■ IceZmodem v1.02, and v1.10 ■ Smodem v1.00 HiGHLANDER has been successfully tested with the following BBS packages: ■ RemoteAccess v2.01, v2.02, and v2.50g1 ■ PCBoard v15.21, and v15.22 ■ Wildcat v4.00 ■ Maximus v2.02 ■ Telegard v2.99 ────────────────────────────────────────────────────────────────────── Page 4 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── 1.5 License Agreement "HiGHLANDER" refers to the executables and documentation contained within the HiGHLANDER distribution archive, officially released by Fonty Technologies (UK) Inc. ■ HiGHLANDER is Copyright (c) 1995, 96 Fonty Technologies (UK) Inc. and may only be used in accordance with the conditions of this License Agreement. ■ You may use HiGHLANDER for a period of thirty (30) days on a trial basis in order to determine it's suitability for your particular application. After this period you are required to either register HiGHLANDER for each system you run or delete the executable files from your system(s). ■ Registration entitles you to use HiGHLANDER and any future versions of HiGHLANDER for as long as you wish, subject to any licensing conditions attached to future versions. ■ Site and group registrations are available, and are dealt with on a case by case basis. ■ You may not modify or reverse engineer the HiGHLANDER executable in any way shape or form. ■ HiGHLANDER may not be used in any unlawfull or illegal manner. ■ You are encoraged to distribute the shareware version of HiGHLANDER provided no fee is charged for it's distribution and that the distribution archive is not modified in any way, shape or form. Pay Bulletin Board Systems and Shareware libraries may charge their normal fee provided no additional charge for HiGHLANDER is levied. ■ HiGHLANDER shall not be included on any CD-ROM compilation without prior arrangement and written permission of the author(s). In the likely hood that permission is granted a distribution and royalty fee will be charged by Fonty Technologies (UK) Inc. ■ Fonty Technologies (UK) Inc. and the author(s) of HiGHLANDER are under no obligation t o provide future versions of, or support for HiGHLANDER. ■ Fonty Technologies (UK) Inc. and the author(s) of HiGHLANDER will under no circumstance be held responsible for any damages or loss that may or may not result from the use of HiGHLANDER. ■ By using HiGHLANDER you are agreeing to the conditions set out in this License Agreement and are therefore releasing Fonty Technologies (UK) Inc. and the author(s) of HiGHLANDER from any liability or litigation. ────────────────────────────────────────────────────────────────────── Page 5 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── 1.6 Disclaimer HiGHLANDER is provided "as is", without warranty of any kind or fitness for a particular purpose, either expressed or implied, all of are hereby explicitly disclaimed. 1.7 Guarantee Fonty Technologies (UK) Inc. guarantee that HiGHLANDER will occupy disk space. Any other guarantees are hereby removed. 1.8 Trademarks All Fonty Technologies (UK) Inc. products are trademarks of Fonty Technologies (UK) Inc. and Steven Holme. Other brands and product names are trademarks of their respective holders. Copyright (c) 1995, 96 Fonty Technologies (UK) Inc. All rights reserved. ────────────────────────────────────────────────────────────────────── Page 6 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── 2 Registration This software is NOT FREE. The unregistered version is distributed as part of the "Shareware" concept for evaluation purposes and as such, you are expected to register it within the evaluation period. If, after this period, you decide not to use the software, you must delete the executable files from your system(s) and not use it again without prior registation. What you get by registering: ■ No more annoying UNREGISTERED messages. ■ The ability to replace the internal "Enter Screen". ■ The ability to replace the internal "Help Screen". ■ Full technical support. ■ Free updates when available (no upgrade fee). ■ More chance of HiGHLANDER being developed further. ■ A personnalised registration key. ■ Statisfaction of supporting the "shareware" concept. The basic registration fee is currently UKP 10. Site and group registrations are dealt with on an individual basis. To register, please read the REGISTER.FRM enclosed in the official HiGHLANDER distribution archive. ────────────────────────────────────────────────────────────────────── Page 7 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── 3 Distribution Archive The HiGHLANDER official distribution archive contains the following files as part of it: Badwords.Cfg - Example bad words configuration file. BBS.Cfg - Example InterBBS configuration file. Descript.ion - 4DOS Description file. File_Id.Ans - ANSi Description file. File_Id.Diz - Description file. Highland.Bat - HiGHLANDER BBS batch file. Highland.Cfg - Default configuration file. Highland.Doc - This documentation. Highland.Exe - The execuatable program. InterBBS.Cfg - Example InterBBS league configuration file. Register.Frm - Registration form. Terms.Reg - Terms and conditions of registration. Upgrade.Doc - Upgrade documentation 4 Additional Files The following addition files for HiGHLANDER are available for download or FREQ from The Fonty Towers BBS: Filename FREQ name Description ---------------------------------------------------------------------- HANSI110.ARJ HIGHANSI HiGHLANDER Additional ANSi Screens. ────────────────────────────────────────────────────────────────────── Page 8 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── 5 Installation 5.1 Quick Installation The section briefly explains how to install HiGHLANDER. HiGHLANDER is not particularly difficult to install and as such this is only a quick guide. I. Create a directory for HiGHLANDER to exist in, e.g "C:\BBS\HIGHLAND". II. Unarchive the HiGHLANDER distribution archive into this directory. III. At this point HiGHLANDER is ready to run. The next step is to configure your BBS software to run HiGHLANDER. The following is an example menu for RemoteAccess. 1 2 3 4 5 6 7 12345678901234567890123456789012345678901234567890123456789012345 ; *C /c \BBS\RA\HIGHLAND.BAT *N *M *UOneliner Action Execute sub-program (Type 7) Display OptData HotKey O AutoExec No Colour Colour example IV. The only other task that remains is to create the batch file which will actually run HiGHLANDER. The following is such an example: @ECHO OFF CD \BBS\HIGHLAND HIGHLAND.EXE /D C:\BBS /N %1 /SYSOP 64000 /WSEC 50 /DEC CD \BBS Please see the section on command line parameters for a more detailed explanation on how to call HiGHLANDER. ────────────────────────────────────────────────────────────────────── Page 9 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── 5.2 Command Line Parameters As with most door programs, HiGHLANDER has several command line parameters. These parameters are as follows: 5.2.1 BBS Parameters /D <path> - The path to the BBS drop file. /N <node> - The node of the BBS that HiGHLANDER is running on. 5.2.2 Communications Parameters /ADDRESS <address> - Which com port address HiGHLANDER should use. Note, only available when the internal comms routines are being used. /B <speed> - Tells HiGHLANDER what speed to communicate with the modem at. When using an unlocked fossil driver the value should be: 300, 1200, 2400, 4800, 9600, or 38400. If the fossil driver is locked then the locked baud rate should be passed. When using the internal comms routines the value should be any rate from 2 to 115,200 that evenly devides 115,200. (i.e. 115200, 57600, 38400, 28800, 23040, 19200, 14400 12800, 9600 etc). /NOFOSSIL - Specify not to use the FOSSIL driver. /IRQ <irq> - Which IRQ the com port is assigned to. Note, only available when the internal comms routines are being used. /NOFIFO - Tells HiGHLANDER not to use a 16550 UART FIFO buffering. /P <port> - Tells HiGHLANDER which com port should be used. Note, only available when the internal comms routines are being used. ────────────────────────────────────────────────────────────────────── Page 10 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── 5.2.3 HiGHLANDER Parameters 5.2.3.1 Standard Parameters /AUTO - Detect the graphics capabilities of the user's terminal automaticly. /BAD <filename> - The full path and filename of the bad words file. /C <path> - The full path and filename of the configuration file. This allows multiply configuration files for multi-node systems. /DEC - Force HiGHLANDER to decrement the user's number of messages written when deleting a oneliner. /DSEC <security> - Minimum security for the download options. /ESEC <security> - The minumum security needed to enter a oneliner. /HANDLES - Force HiGHLANDER to use the users handles rather than full names. /HELP or /? - Displays a list of all HIGHLANDER command line arguments. /HFILE <filename> - Specifies the full path and filename to the help screen .ANS/AVT/RIP file. /LOCAL - Force HiGHLANDER to run in local mode. /MFILE <filename> - Specifies the full path and filename to the main screen .ANS/AVT/RIP file. /SYSOP <security - Minimum security for the sysop functions. /TOP <number> - Tell HiGHLANDER how many top oneliner writers to display. i.e. /TOP10. /TSEC <security> - The minumum security needed to display the date and time details. /VSEC <security> - The minumum security needed to view the bulletin files. /WSEC <security> - The minumum security needed to display the 'who wrote what' details. 5.2.3.2 Bulletin File Parameters /WRITERSASC <path> - The full path and filename to the ASCII top writers bulletin file. /WRITERSANS <path> - The full path and filename to the ANSI top writers bulletin file. /WRITERSAVT <path> - The full path and filename to the Avatar top writers bulletin file. /NONASC <path> - The full path and filename to the ASCII non writers bulletin file. /NONANS <path> - The full path and filename to the ANSI non writers bulletin file. /NONAVT <path> - The full path and filename to the Avatar non writers bulletin file. ────────────────────────────────────────────────────────────────────── Page 11 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── 5.3 The Configuration File The following is a list of accepted keywords and parameters which may exist within a HiGHLANDER configuration file: 5.3.1 BBS Commands SysopName <name> This is where you tell HiGHLANDER who the sysop is (normally you). Only needed if the BBS's door information file (drop file) does not speficy who the sysop is. SystemName <bbs name> This is how you tell HiGHLANDER the name of the BBS. Only needed if the BBS's drop file does not specify the system name. Node <node number> This is normally only necessary if the node number is not contained within the BBS's drop file. BBSDir <path> Default: Current directory BBS system directory. Indicates where the door information file can be located. 5.3.2 Communications Related Commands LockedBPS <speed> This specifies the BPS rate at which HiGHLANDER should communicate with the modem. This is only needed if the BBS's drop file does not contain this information. FossilPort <port> Specifies the FOSSIL driver port number that the modem is connected to. FOSSIL port 0 corresponds to COM 1, port 1 to COM 2, and so on. This is only necessary if this information is not specified in the BBS's drop file. ────────────────────────────────────────────────────────────────────── Page 12 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── 5.3.3 HiGHLANDER Related Commands 5.3.3.1 Standard Commands DoorDir <path> Default: Current directory HiGHLANDER's working directory. This is where all the HiGHLANDER data files are stored. LogFileName <full path> Default: Highland.Log This option specifies the log file path and file name to use for logging user activity. DisableLogging <boolean> Default: Off Prevents HiGHLANDER from writting to a log file. MaximumDoorTime <seconds> Default: Time remaining on BBS Maximum length of time a user is permitted to access HiGHLANDER. InactivityTimeout <seconds> How to tell HiGHLANDER what the inactivity timeout should be. MainScreenFileName <path> Default: Highland Specifies the full path and file name of the main screen .ANS/AVT/RIP file. Do not include an extension if you wish to display different files for different terminal graphics modes. EnterScreenFileName<path> Default: HighHelp Specifies the full path and file name of the enter screen .ANS/AVT/RIP file. Do not include an extension if you wish to display different files for different terminal graphics modes. HelpScreenFileName <path> Default: HighHelp Specifies the full path and file name of the main screen .ANS/AVT/RIP file. Do not include an extension if you wish to display different files for different terminal graphics modes. TitleX <x position> Default: 18 Specifies the x position (column number) for the program title. TitleY <y position> Default: 1 Specifies the y position (row number) for the program title. ────────────────────────────────────────────────────────────────────── Page 13 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── TitleStyle <style> Default: Ice Specifies the colour style that the program title, copyright message, logo, oneliner entry box, and default help screen appear in. The possible styles are: Ice - Blues and White Fire - Red, Yellow, and White Fresh - Greens and White Metal - Greys and White Gothic - Purples and White CopyrightX <x position> Default: 15 Specifies the x position (column number) for the copyright message. CopyrightY <y position> Default: 22 Specifies the y position (row number) for the copyright message. TotalLines <boolean> Default: On Specifies whether or not the total number of oneliners written, is to be displayed. TotalLinesColour <colour> Default: Bright cyan on black Specifies the colour of the total number of oneliners written field. TotalLinesX <x position> Default: 74 Specifies the x position (column number) of the total number of oneliners written field. TotalLinesY <y position> Default: 15 Specifies the y position (row number) of the total number of oneliners written field. YourLines <boolean> Default: On Specifies whether or not the users total number of oneliners written, is to be displayed. YourLinesColour <colour> Default: Bright cyan on black Specifies the colour of the users total number of oneliners written field. YourLinesX <x position> Default: 74 Specifies the x position (column number) of the users total number of oneliners written field. ────────────────────────────────────────────────────────────────────── Page 14 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── YourLinesY <y position> Default: 16 Specifies the y position (row number) of the users total number of oneliners written field. Percentage <boolean> Default: On Specifies whether or not the percentage is to be displayed. PercentageColour <colour> Default: Bright cyan on black Specifies the colour of the "% of users logging on today have written a message" field. PercentageX <x position> Default: 54 Specifies the x position (column number) of the "% of users loggin on today have written a message" field. PercentageY <y possition> Default: 16 Specifies the y position (row number) of the "% of users logging on today have written a message" field. OnelineForegroundColour <colour> Default: White Specifies the foreground colour in which the oneliners appear. If the <colour> field contains "Pattern", or "Random" then the colour of each oneliner will either follow a preset pattern or be generated randomly. If the <colour> field contains "UserSelect" then the user will be able to select their prefered colour via a light bar menu selector. OnelineBackgroundColour <colour> Default: Black Specifies the background colour in which the oneliners appear. OnelineX <x position> Default: 2 Specifies the x position (column number) of the oneliners. OnelineY <y position> Default: 2 Specifies the starting y position (row number) of the oneliners. QuoteForegroundColour <colour> Default: Bright black Specifies the foreground colour in which the quote marks around the oneliner appear. QuoteBackgroundColour <colour> Default: Black Specifies the background colour in which the quote marks around the oneliner appear. ────────────────────────────────────────────────────────────────────── Page 15 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── DeleteForegroundColour <colour> Default: White Specifies the foreground colour in which any deleted oneliners appear. DeleteBackgroundColour <colour> Default: Black Specifies the background colour in which any deleted oneliners appear. TopTableLength <length> Default: 10 Specifies the length of the top oneliner writers. TopTableColour <colour> Default: Bright cyan on black Specifies the colour of the "number of messages written" in the top table. TopTableX <x possition> Default: 75 Specifies the x position (column number) of the "number of messages written" in the top table. TopTableY <y possition> Default: 3 Specifies the starting y position (row number) of the "number of messages written" in the top table. NamesColour <colour> Default: Bright cyan on black Specifies the colour of the names within the top table. Please note, that whether 'bright' is used or not, the 1st name in the top table will appear bright and all others dull. NamesX <x possition> Default: 57 Specifies the x position (column number) of the names within the top table. NamesY <y possition> Default: 3 Specifies the starting y position (row number) of the names within the top table. PromptX <x possition> Default: 1 Specifies the x position (column number) of the main prompt. PromptY <y possition> Default: 23 Specifies the y position (row number) of the main prompt. EnterPromptY <y possition> Default: 8 Specifies the y position (row number) of the enter oneliner prompt. ────────────────────────────────────────────────────────────────────── Page 16 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── EnterOnelinerY <y possition> Default: 12 Specifies the y position (row number) of where user input of the oneliner takes place. SelectProtocolTitleText <text> Default: Select Protocol Specifies the select protocol title. SelectProtocolTitleColour <colour> Default: Blue on black Specifies the colour of the select protocol title. SelectProtocolPromptText <text> Default: Select: Specifies the select protocol prompt. SelectProtocolPromptColour <colour> Default: Blue on black Specifies the colour of the select protocol prompt. EnterPromptText <text> Default: Enter your Oneliner below Specifies the enter oneliner prompt. EnterPromptColour <colour> Default: Bright cyan on black Specifies the colour of the delete oneliner prompt. BoxTop <possition> Default: 14 Specifies the top most row number of the box which is cleared if a user doesn't enter a oneliner, and says "Perhaps next time!". This is normally over the copyright and total messages information. BoxLeft <possition> Default: 52 Specifies the left most column number of the box which is cleared if a user doesn't enter a oneliner. BoxBottom <possition> Default: 21 Specifies the bottom most row number of the box which is cleared if a user doesn't enter a oneliner. BoxRight <possition> Default: 79 Specifies the right most column number of the box which is cleared if a user doesn't enter a oneliner. Handles <boolean> Default: False Allows the sysop to specify whether or not handles are to be used instead of user's full names. ────────────────────────────────────────────────────────────────────── Page 17 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── DecUserOnDelete <boolean> Default: False Specfies whether or not the number of oneliners a user has written, is to be decremented when the sysop deletes a oneliner. BadWordsFile <path> Default: BadWords.Cfg Allows the specifing of a bad words list file. This list will be used to check the users oneliners for any bad words. AnimatedPrompts <boolean> Default: On Allows the enabling/disabling of the animated prompt on the help screen. ChatUtility <command line> Default: Blank Specifies the command line to execute an external chat utililty. When this field is blank the internal chat functions will be used. FreezeChatTimer <boolean> Default: Off Allows the enabling/disabling of the chat timer during an external chat program. UnknownBBSText <text> Default: Unknown BBS Text to be displayed when the BBS origin of a oneliner is unknown. UnknownWriterText <text> Default: Unknown Writer Text to be displayed when the writer of a oneliner is unknown. UnknownMessageText <text> Default: Unknown Oneliner Text to be displayed when the oneliner message is unknown. CheckingNetmailText <text> Default: Checking Netmail for InterBBS messages Specifies the text to be displayed when HiGHLANDER is checking the netmail directory for interBBS messages. ProcessingInterBBSText <text> Default: Processing InterBBS message Specifies the text to be displayed when HiGHLANDER is processing interBBS messages. NoNewInterBBSText <text> Default: No new InterBBS messages Specifies the text to be displayed when HiGHLANDER can not find any new interBBS messages. ────────────────────────────────────────────────────────────────────── Page 18 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── 5.3.3.2 Security Commands EnterSecurity <sec level> Default: 0 This specifies what the user's security level needs to be in order to enter a oneliner. ViewBBSSecurity <sec level> Default: 0 This specifies what the user's security level needs to be in order to view the BBS origin of each oneliner. ViewDateTimeSecurity <sec level> Default: 0 This specifies what the user's security level needs to be in order to view the date and time of each oneliner. ViewWriterSecurity <sec level> Default: 0 This specifies what the user's security level needs to be in order to view the writer of each oneliner. ViewBulletinSecurity <sec level> Default: 0 This specifies what the user's security level needs to be in order to view the bulletin files. DownloadBulletinSecurity <sec level> Default: 0 This specifies what the user's security level needs to be in order to download the bulletin files. ChangeProtocolSecurity <sec level> Default: 0 This specifies what the user's security level needs to be in order to change their protocol settings. SysopSecurity <sec level> Default: 64000 This specifies what the user's security level needs to be in order to access the sysop functions. ────────────────────────────────────────────────────────────────────── Page 19 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── 5.3.3.3 Menu Commands YesKey <character> Default: y Specifies the user input keyboard character to enter a oneliner. NoKey <character> Default: n Specifies the user input keyboard character to quit HiGHLANDER. ViewBBSKey <character> Default: b Specifies the user input keyboard character to display the BBS origin for each oneliner. ViewDateTimeKey <character> Default: t Specifies the user input keyboard character to display the date and time for each oneliner. ViewWriterKey <character> Default: w Specifies the user input keyboard character to display the writer of each oneliner. ViewBulletinKey <character> Default: v Specifies the user input keyboard character to display the bulletin files. DownloadBulletinKey <character> Default: d Specifies the user input keyboard character to enable the user to download the bulletin files. ChangeProtocolKey <character> Default: p Specifies the user input keyboard character to allow the user to change their protocol settings. HelpKey <character> Default: ? Specifies the user input keyboard character to display the help page. ReplaceKey <character> Default: r Specifies the user input keyboard character to access the replace function. Note, this is only available to users with a security level greater, or equal to that of the specified sysop security level. ────────────────────────────────────────────────────────────────────── Page 20 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── DeleteKey <character> Default: e Specifies the user input keyboard character to access the delete function. Note, this is only available to users with a security level greater, or equal to that of the specified sysop security level. MenuPromptText <text> Default: Choose your option Specifies the text for the main menu prompt. MenuPromptColour <colour> Default: Blue on black Specifies the colour of the main menu prompt. MenuOptionsColour <colour> Default: Bright blue on black Specifies the colour of the options which appear at the end of the main menu prompt. ViewBulletinPromptText <text> Default: Which Bulletin do you want to view? Specifies the view bulletin prompt. ViewBulletinPromptColour <colour> Default: Blue on black Specifies the colour of the view bulletin prompt. ViewBulletinOptionsColour <colour> Default: Bright blue on black Specifies the colour of the options that appear at the end of the view bulletin prompt. DownloadBulletinPromptText <text> Default: Which Bulletin do you want to download? Specifies the download bulletin prompt. DownloadBulletinPromptColour <colour> Default: Blue on black Specifies the colour of the download bulletin prompt. DownloadBulletinOptionsColour <colour> Default: Bright blue on black Specifies the colour of the options that appear at the end of the download bulletin prompt. ReplacePromptText <text> Default: Which Oneliner do you want to replace? Specifies the replace oneliner prompt. ────────────────────────────────────────────────────────────────────── Page 21 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── ReplacePromptColour <colour> Default: Blue on black Specifies the colour of the replace oneliner prompt. ReplaceOptionsColour <colour> Default: Bright blue on black Specifies the colour of the options that appear at the end of the replace oneliner prompt. DeletePromptText <text> Default: Which Oneliner do you want to delete? Specifies the delete oneliner prompt. DeletePromptColour <colour> Default: Blue on black Specifies the colour of the delete oneliner prompt. DeleteOptionsColour <colour> Default: Bright blue on black Specifies the colour of the options that appear at the end of the delete oneliner prompt. 5.3.3.4 Bulletin Commands TopWritersAsciiBulletinFile <path> Default: Writers.Asc This option specifies the name and location of the Top Writers ASCII Bulletin File which will be written when HiGHLANDER exits. TopWritersAnsiBulletinFile <path> Default: Writers.Ans This option specifies the name and location of the Top Writers ANSI Bulletin File which will be written when HiGHLANDER exits. TopWritersAvatarBulletinFile <path> Default: Writers.Avt This option specifies the name and location of the Top Writers Avatar Bulletin File which will be written when HiGHLANDER exits. NonWritersAsciiBulletinFile <path> Default: !Writers.Asc This option specifies the name and location of the Non Writers ASCII Bulletin File which will be written when HiGHLANDER exits. NonWritersAnsiBulletinFile <path> Default: !Writers.Ans This option specifies the name and location of the Non Writers ANSI Bulletin File which will be written when HiGHLANDER exits. ────────────────────────────────────────────────────────────────────── Page 22 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── NonWritersAvatarBulletinFile <path> Default: !Writers.Avt This option specifies the name and location of the Non Writers Avatar Bulletin File which will be written when HiGHLANDER exits. The following is a list of the field colours which apply to the Top Writers bulletin file: TopWritersTitleColour Default: Bright yellow on black TopWritersTitleUnderlineColour Default: Bright white on black TopWritersMainUnderlineColour Default: Bright red on black TopWritersUsernameTitleColour Default: Bright white on black TopWritersOnelinersTitleColour Default: Bright white on black TopWritersUsernameColour Default: Bright green on black TopWritersOnelinersColour Default: Bright cyan on black The following is a list of the field colours which apply to the Non Writers (users that have not writen any oneliners) bulletin file: NonWritersTitleColour Default: Bright yellow on black NonWritersTitleUnderlineColour Default: Bright white on black NonWritersMainUnderlineColour Default: Bright red on black NonWritersUsernameTitleColour Default: Bright white on black NonWritersUsernameColour Default: Bright green on black GeneratingTopWritersASCIIText <text> Default: Generatring Top Writers ASCII Bulletin Specifies the text displayed when generating the top writers ASCII bulletin file. GeneratingTopWritersANSIText <text> Default: Generatring Top Writers ANSI Bulletin Specifies the text displayed when generating the top writers ANSI bulletin file. GeneratingTopWritersAVTText <text> Default: Generatring Top Writers Avatar Bulletin Specifies the text displayed when generating the top writers avatar bulletin file. ────────────────────────────────────────────────────────────────────── Page 23 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── GeneratingNonWritersASCIIText <text> Default: Generatring Non Writers ASCII Bulletin Specifies the text displayed when generating the non writers ASCII bulletin file. GeneratingNonWritersANSIText <text> Default: Generatring Non Writers ANSI Bulletin Specifies the text displayed when generating the non writers ANSI bulletin file. GeneratingNonWritersAVTText <text> Default: Generatring Non Writers Avatar Bulletin Specifies the text displayed when generating the non writers avatar bulletin file. TopWritersASCIIBulletin <boolean> Default: On Specifies whether to generate the top writers ASCII bulletin file. TopWritersANSIBulletin <boolean> Default: On Specifies whether to generate the top writers ANSI bulletin file. TopWritersAVTBulletin <boolean> Default: On Specifies whether to generate the top writers avatar bulletin file. NonWritersASCIIBulletin <boolean> Default: On Specifies whether to generate the non writers ASCII bulletin file. NonWritersANSIBulletin <boolean> Default: On Specifies whether to generate the non writers ANSI bulletin file. NonWritersAVTBulletin <boolean> Default: On Specifies whether to generate the non writers avatar bulletin file. ────────────────────────────────────────────────────────────────────── Page 24 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── 5.3.3.5 Protocol Commands In order to add download capabilities to HiGHLANDER there are three protocol commands, which you need to use in the configuration file, for each protocol you add. It is possible to use a maximum of 255 protocols with HiGHLANDER. Please note, that in the following list of commands 'X' (without quotes) represents a number from 1 to 255. ProtocolXKey <character> e.g: Z Specifies the user key press in order to select the given protocol. ProtocolXCommandLine <command line> e.g: GSZ.EXE port *P *F This command specifies the command line and arguments necessary to execute the external protocol. Please note, in order to specify the communications port, baud rate, node number and filename the following macros are used: *B Baud Rate *C Com Port (1 based COM Port) *N Node Number *P Fossil Port (0 based COM Port) *F Filename ProtocolXDescription <description> e.g: Zmodem This option specifies the title of the given protocol. 5.3.6 A Note On The Colour Parameters The colour parameters are not (as most of you will probably expect) required to be complicated numerical values, which have to be calculated depending on what background colour you have. In fact all colour parameters can be specified in english. The following is an example list of valid colour parameters: Bright white on black Bright red on black Bright blue on blue Bright black on black (Necessary to get dark grey on black) Red on green Cyan on yellow ────────────────────────────────────────────────────────────────────── Page 25 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── 5.4 InterBBS configuration files In order to run HiGHLANDER in interbbs mode you must have two configuration files setup which detail your bbs settings and the other member boards within the league. The InterBBS.Cfg file specifies all nodes within the league. It is the responsibility of the league coordinator (node 1) to update and distribute this file when necessary. InterBBS.Cfg is as follows: <node> <bbs name> <bbs ftn address> <city> <state code> <country code> <blank line> This must be repeated for each BBS within the league. An example InterBBS.Cfg follows: 1 The Fonty Towers BBS 2:2503/201 Nottingham UK 2 Your BBS name Your BBS node address Your location UK Note, the state and counry codes must each be 2 characters. ie. US - United States of America UK - United Kingdom FR - France CA - California NY - New York OH - Ohio ────────────────────────────────────────────────────────────────────── Page 26 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── The BBS.Cfg file details your own BBS's settings. The format of this file follows: <sysop name> <bbs name> <bbs node address> <inbound mailer directory> <netmail directory> <league number> <mailer> Note, the only mailer supported at the moment is "FrontDoor". An example BBS.Cfg file follows: Steven Holme The Fonty Towers BBS 2:2503/201 E:\INBOUND E:\NETMAIL 1 FRONTDOOR 5.5 Maintanence Unlike alot of BBS door programs, HiGHLANDER does not require a seperate program to be ran in the BBS's nightly maintanence. All necessary maintanence is carried out when HiGHLANDER is ran as a door. However, If HiGHLANDER is being ran in interBBS mode is is recommended that HIGHLANDER /MAINT is ran within your mail processing batch files. ────────────────────────────────────────────────────────────────────── Page 27 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── 6 Future Versions The following list describes some of the enhancements that Fonty Technoloies (UK) Inc. have planed for future versions of HiGHLANDER: ■ Macro replacement - Allow replacement of %USER%, @USER@, %LOCATION%, styled macros. ■ Support for route.cfg - Allow interBBS packets to be routed by HiGHLANDER. ■ Generate interbbs.cfg - Automatic generation of InterBBS.Cfg. Which would be sent to all BBSes within the league via netmail. ■ InterBBS statistics - Allow the user to view statistics for interBBS activity. ■ RIP Graphics - Add support for RIP graphics. ■ LightBars - Depending on user response on this one, I would like to add support for LightBar controls. If you have any suggestions for future releases of HiGHLANDER then please drop us a line and let us know your ideas. 7 Credits The HiGHLANDER oneliner door program and it's documentations was written by Steven Holme. HiGHLANDER distribution, registration and support services are provided by Steven Holme. Testing and evaluation of HiGHLANDER is provided by the Fonty Technologies Inc. beta team. All executables and documentation contained in the HiGHLANDER distribution archive are Copyright (c) 1995, 96 Fonty Technologies (UK) Inc. All rights reserved. ────────────────────────────────────────────────────────────────────── Page 28 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── 7.1 Thanks The author(s) of HiGHLANDER would like to personnally thank the following persons (in no particular order): Lee Dunlin, Dream Line BBS - For making Steven Holme the Amiga CoSysop of Dream Line BBS from Feburary 1994 to September 1994 for without this The Fonty Towers BBS would niether have been started or exist. Also for his help and support in starting The Fonty Towers BBS. Unfortunately Dream-Line BBS has now closed nodes 2, 3 and 4. Jay7, The Diamond Line BBS - For the initial idea of HiGHLANDER. Aardvark@innotts.co.uk - For distributing this program on the net. Deborah Hunt (Ex-Fiance) - For her time and patience with Steven whilst writing this software and running the BBS. Unfortunately her patience ran out! :-( Andrew Milner - For RemoteAccess BBS software. Brian Pirie - For the OpenDoors BBS Door programming Toolkit. HiGHLANDER was developed with OpenDoors v5.00 and v6.00. D-ViBE / REBELS - For the general idea of what a oneliner program should look like and consist of. 7.2 Contributions The following persons have contributed ideas for HiGHLANDER: Simon Groom Mike Smith Andy Sayers Jonathan Irvine Craig Cunningham The following persons have contributed ANSi screens: Craig Cunningham of PUBBS: Outer Limits ────────────────────────────────────────────────────────────────────── Page 29 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── 7.3 The Beta Testers The Fonty Technologies (UK) Inc. beta team consists of the following persons: Dwayne Heaton Virtual Maddness BBS +44-1344-422575 FidoNet: 2:252/314 RANet: 73:7441/13 Craig Cunningham PUBBS: Outer Limits +44-115-974-6427 FidoNet: 2:2503/210 RANet: 73:7444/210 Ross Bamford The Freight Train BBS +44-115-NOW-DOWN FidoNet: 2:2503/109 RANet: 73:7444/109 Michal Nguyen PC's Comp Tech USA BBS +1-214-357-5613 Tom De Puysseleyr Braindeath BBS +32-3-4542902 FidoNet: 2:292/8125 All the users of The Fonty Towers BBS for beta testing all releases of HiGHLANDER. If you would like to become a beta tester then please contact Fonty Technologies stating why, and what you can offer in terms of a testing environment. 7.4 InterBBS Leagues The following is a list of all known HiGHLANDER leagues. If you would like your league including please mail your details, including a list of all the member systems, to Fonty Technologies (UK) Inc. League Coordinator Node System Net address ---------------------------------------------------------------------- 1 Steven Holme 01 The Fonty Towers BBS 2:2503/201 02 PUBBS: Outer Limits 2:2503/210 ────────────────────────────────────────────────────────────────────── Page 30 HiGHLANDER v2.00 Documentation ────────────────────────────────────────────────────────────────────── 8 Support If you need help, information or technical support, or would like to apply as a beta tester then please contact us using one of the methods listed below: 8.1 By Post Fonty Technologies (UK) Inc. 97 Plains Road Mapperley Nottingham NG3 5QT ENGLAND 8.2 By BBS The Fonty Towers BBS -=-=-=-=-=-=-=-=-=-= Node 1: +44-115-952-7443 USR Courier 33,600bps Node 2: +44-115-955-3402 Trust 14,400bps Node 3: +44-115-955-3426 Trust 14,000bps Node 4: +44-115-955-4440 Trust 14,000bps 8.3 By E-Mail For support by E-Mail please Netmail "Steven Holme" at one of the following networks: FidoNet: 2:2503/201, 201, 201, 201 (Nottingham HUB) DiamondNet: 52:5210/101, 102, 103, 104 (UK RC) RANet: 73:7444/201, 202, 203, 204 (Net 7444 NC) TrekNet: 107:1713/201, 202, 203, 204 (Net 1713 NC) IncarNet: 153:175/201, 202, 203, 204 (Nottingham HUB) MercuryNet: 240:290/201, 201, 203, 204 (Net 290 NC) FABNet: 1995:17/201, 202, 203, 204 BBSNet: 405:130/2 UFONet: 405:130/2 InterNet: kewlkat@innotts.co.uk steven.holme@fonty.coastmnl.co.uk steven.holme@helpdesk.kingston-net.co.uk ────────────────────────────────────────────────────────────────────── Page 31 HiGHLANDER 2.00 Documentation ────────────────────────────────────────────────────────────────────── 9 Contributions If any person using this product, designs their own 'Main Screen' with configuration file and would like to have their efforts distributed with future releases of HiGHLANDER then please send your work to Fonty Technologies (UK) Inc. at any of the above addresses. You will be credited in the HiGHLANDER documentation for your work. Additionally, help with any of future features of HiGHLANDER will be greatfully received. 10 And On a Last Note Thank you for trying HiGHLANDER. \\||// [ _ _ ] .. ____ ────────────────────────────────────────────────────────────────────── Page 32